DBS-Based Services Backup

This topic describes automatic backup for CygNet DBS-based services. The DBS-based services include:

• Access Control Service (ACS)
• Blob Services (APPS and BSS)
• Audit Service (AUD)
• Database Service (DBS)
• Device Definition Service (DDS)
• Event Logging Services (ELS and ELSALM)
• Facility Service (FAC)
• General Notification Service (GNS)
• Group Service (GRP)
• Master Scheduling Service (MSS)
• Point Service (PNT)
• Table Reference Service (TRS)

These services use Microsoft’s Extensible Storage Engine (ESE) technology, which provides for a robust transaction logging system and sophisticated recovery feature that guarantees data integrity and consistency in the event of a system crash. CygNet’s DBS-services support a configurable memory cache, configurable log file size and location, automatic backup, full and incremental backup, backup scheduling in the MSS, backup on demand, and database restoration from point in time. See Data Storage for DBS-Based Services for more information about this technology.

The automatic backup feature backs up the database file (.dat.edb), the index file (.inx.edb), and the temporary storage files (ts.edb) to the databackup\new directory of the location specified in the BACKUP_PATH keyword. The service configuration file (.cfg), the data schema file (.ddl), and metadata.dat files are backed up to the root Backup directory for each service. Other files that are backed up to this Backup directory include:

• ACS — Admin.sec
• ARS — CvsMetadata.xml, CygNet.lic, CygNetDomainDefs.xml, CygNetMeter.db, CygNetTimeZones.xml, and ServiceDefs.####.db
• AUD — HeadersToBeUpdated.bak, HeadersToBeUpdated.dat
• CAS — AlmHistPersist.bak, AlmHistPersist.dat, CasMetadata.dat, CasPersist.bak, and CasPersist.dat
• CVS — CVS.Persist.bak, CVS.Persist.dat
• GNS — GnsAckFile.dat, NotifQueuePersist.dat, and ReSendQueuePersist.dat
• NOTE — HeadersToBeUpdated.bak, HeadersToBeUpdated.dat
• PNT — PNTMetaData.dat
• RSM — SVCDEF.RSX

Backup Keywords

Configure the following keywords with a valid parameter in each service configuration file to enable automatic backup for the selected DBS-based service:

• BACKUP_PATH
• BACKUP_TIME
• COPY_BACKUP_TO
• DBS_BACKUP_ATOMIC (ELS only)

See Backup Keywords and Paths for definitions. See the relevant DBS-based Service Configuration File Keywords document (ACS, APPS, AUD, BSS, DBS, DDS, ELS, ELSALM, FAC, GNS, GRP, MSS, PNT, and TRS) for configuration keyword defaults and options.

Full and Incremental Backups

The daily automatic backup that is defined in the service configuration file is a full backup. A full backup can be also scheduled through the MSS.

An incremental backup can be only scheduled thorough the MSS. If the backup process is an incremental one, the transaction log files are written to the backup directory (specified in the BACKUP_PATH keyword) and are stored there until a full backup is performed. When a full backup is performed, the database is checked to make sure it contains the information from the log files and then the log files are deleted from the system. Incremental backups only apply to DBS-based services.

See Scheduling a Backup with the MSS for more information about scheduling incremental backups.

See Transaction Log Files and DBS Backup for more information about how transaction log files are handled during a full and incremental backup.